Node / meshtastic / Meshtastic-Android / files / core / ble / src / commonTest / kotlin / org / meshtastic / core / ble / BleScanStartExceptionTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.ble

Tff7b72import T7ee787co.touchlab.kermit.Severity

Tff7b72import T7ee787com.juul.kable.UnmetRequirementReason

Tff7b72import T7ee787org.meshtastic.core.common.log.isExpectedCondition

Tff7b72import T7ee787org.meshtastic.core.common.log.shouldReportAsException

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFalse

Tff7b72import T7ee787kotlin.test.assertTrue

T8b949e/**

* A BLE scan refused by the environment must never reach a crash reporter.

*

* Bluetooth off, location services off and a missing scan permission were four of the loudest Crashlytics issues during

* 2.8.0 triage, all of them non-actionable.

*/

Tff7b72class T56d364BleScanStartExceptionTest Tb4b4b4{

Tf0883e@Test

Tff7b72fun Td2a8ff`every scan-start failure is an expected condition`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3reason Tff7b72-Tff7b72>

Tff7b72val Te6edf3exception Tff7b72= Te6edf3BleScanStartExceptionTb4b4b4(Te6edf3reasonTb4b4b4, Te6edf3cause Tff7b72= Te6edf3IllegalStateExceptionTb4b4b4(Ta5d6ff"Ta5d6ffcauseTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3exceptionTb4b4b4.Te6edf3isExpectedConditionTb4b4b4(Tb4b4b4)Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3reasonTa5d6ff must be an expected conditionTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3reasonTb4b4b4.Te6edf3labelTb4b4b4, Te6edf3exceptionTb4b4b4.Te6edf3expectedConditionLabelTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`scan-start failures are never reported even when logged at error`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3reason Tff7b72-Tff7b72>

Tff7b72val Te6edf3exception Tff7b72= Te6edf3BleScanStartExceptionTb4b4b4(Te6edf3reasonTb4b4b4, Te6edf3cause Tff7b72= Te6edf3IllegalStateExceptionTb4b4b4(Ta5d6ff"Ta5d6ffcauseTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertFalseTb4b4b4(

Te6edf3shouldReportAsExceptionTb4b4b4(Te6edf3SeverityTb4b4b4.Te6edf3ErrorTb4b4b4, Te6edf3exceptionTb4b4b4)Tb4b4b4,

Ta5d6ff"Tffd700$Te6edf3reasonTa5d6ff must not be recorded as a non-fatalTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`labels are unique and low cardinality`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3labels Tff7b72= Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3label Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3labelsTb4b4b4.Te6edf3sizeTb4b4b4, Te6edf3labelsTb4b4b4.Te6edf3toSetTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3sizeTb4b4b4, Ta5d6ff"Ta5d6fflabels must be unique to be usable as rate keysTa5d6ff"Tb4b4b4)

Te6edf3labelsTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3label Tff7b72-Tff7b72>

Te6edf3assertTrueTb4b4b4(Te6edf3labelTb4b4b4.Te6edf3isNotBlankTb4b4b4(Tb4b4b4)Tb4b4b4, Ta5d6ff"Ta5d6fflabel must not be blankTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3labelTb4b4b4.Te6edf3lowercaseTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3labelTb4b4b4, Ta5d6ff"Ta5d6fflabel 'Tffd700$Te6edf3labelTa5d6ff' must be lowercase for stable groupingTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e// Kable's UnmetRequirementException has an internal constructor, so the reason mapping is verified directly.

Tf0883e@Test

Tff7b72fun Td2a8ff`kable unmet-requirement reasons map onto scan-start reasons`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3BluetoothDisabledTb4b4b4,

Te6edf3UnmetRequirementReasonTb4b4b4.Te6edf3BluetoothDisabledTb4b4b4.Te6edf3toBleScanStartFailureReasonTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(

Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3LocationServicesDisabledTb4b4b4,

Te6edf3UnmetRequirementReasonTb4b4b4.Te6edf3LocationServicesDisabledTb4b4b4.Te6edf3toBleScanStartFailureReasonTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`every kable unmet-requirement reason is mapped`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// Guards against a Kable upgrade adding a reason that silently falls through to error-level logging.

Te6edf3UnmetRequirementReasonTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3toBleScanStartFailureReasonTb4b4b4(Tb4b4b4) Tb4b4b4}

Tb4b4b4}

Tb4b4b4}